home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / kitytrax.zip / KITYTRAX.DOC < prev    next >
Text File  |  1992-10-20  |  43KB  |  1,149 lines
  1.  
  2.  
  3.  
  4.                 ┬ ┌  ─┬─ ─┬─ ─┬─ ┬ ┬   ─┬─  ┬─┐  ┌─┐ ┬ ┌  ┌─┐
  5.                 ├─┴┐  │   │   │  └┬┘ -- │   ├─┴┐ ├─┤ ├─┴┐ └─┐
  6.                 ┴  ┴  ┴   ┴   ┴   ┴     ┴   ┴  ┴ ┴ ┴ ┴  ┴ └─┘  (TM)
  7.                  ┌──┬──┐           ┬──┐
  8.                     │ ┌─┐ ┬─┐ ┌─   │  │ ┬─┐  ─┬─ ┬  ┬ ┌─
  9.                     │ ├─┤ ├─┘ ├    │  │ ├─┴┐  │  └┐┌┘ ├
  10.                     │ ┴ ┴ ┴   └─   ┴──┘ ┴  ┴ ─┴─  └┘  └─ 
  11.  
  12.                       CUSTOM ONLINE TAPE-DRIVE SYSTEMS
  13.                                  PRODUCT OF
  14.                              CYBERDYNE SYSTEMS(tm)
  15.  
  16.            KityTrax v0.01b COPYRIGHT (c)  1992 by Bryan E. Paulson
  17.  
  18.            An ONLINE live door program for use with Wildcat(tm)3.0+
  19.            and IRWIN(tm) tape drive systems
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37. WARNING! if you are considered to be a sysop with cold heart that has
  38. hardened over your years from running a bulletin board, then perhaps this is
  39. your chance to feel the warmth begin to return................NOT!!!!!!!!!!!
  40.                     
  41. Seriously, although this is my first "real" attempt at writing a program and
  42. it's documentation, it is the intended purpose to make these docs easy to be
  43. understood by the "wet behind the ears" rookie as well as the "grizzled vet".
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  ───────────────────────────────────────────────────────────────────────────
  69.   KITY-TRAX version 0.01b                                             Page 1
  70.  ───────────────────────────────────────────────────────────────────────────
  71.  
  72.   Table of Contents
  73.  
  74.  
  75.             Title Page..........................     Front Cover
  76.             Index...............................     Page  1
  77.             Introduction........................     Page  2
  78.             Limited Warranty....................     Page  3
  79.             Bug Reporting.......................     Page  4
  80.             Rookies'Installation Guide .........     Page  4  - 10
  81.             Grizzled sysop's Installation guide.     Page  11
  82.             Menu creation.......................     Page  12
  83.             Using file areas already established     Page  12 - 13
  84.             Known problems with this program....     Page  13
  85.             System Requirements.................     Page  14
  86.             Last Word...........................     Page  15
  87.             Acknowlagements.....................     Page  16
  88.             Copyrights & Registration...........     Page  17
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  ───────────────────────────────────────────────────────────────────────────
  134.   MAILBASE Version 3                                                  Page 2
  135.  ───────────────────────────────────────────────────────────────────────────
  136.  
  137. INTRODUCTION
  138.   Boy!, Geeze, where do I start?.......Well, This program was created
  139. out of a need for additional storage space without the cost of paying
  140. for another large hard drive, and let's face it, money doesn't grow from
  141. trees, especially for sysops!  With the comming of the CD-ROM, came mass
  142. storage at a somewhat reasonable price but with a compromise, that being the
  143. fact that unless you had about $9,000.00, you could ONLY read from the CD-ROM.
  144.  
  145.   So I went on a quest for finding a live door program that would do such a
  146. task, but alass, the only such software out there in Shareware land was for
  147. those who had a "Colorado"(tm) tape drive, or one that was able to except
  148. filename(s) on the command line as %1,%2,%3,etc.
  149.  
  150.   Since I don't own a tape drive by "Colorado"(Mountain Memory systems)(tm)
  151. but rather one manufactured by "Irwin Magnetics"(tm) and of course "THEY"
  152. had to be different, I developed KityTrax.....
  153.  
  154.   KityTrax is a live door program written for any bulletin board package
  155. that creates a DOOR.SYS & USERINFO.DAT when exiting in order to run a live
  156. door.  At this point of development, I can only say for sure that the
  157. program will run correctly on a wildcat v3.0+ bulletin board system.  I will
  158. be developing conversion utilities to distribute along with this program but
  159. at this time Wildcat is the ONLY "officially" support software.
  160.  
  161.   KityTrax has the following features that sets it apart from it's
  162. competitors: 
  163.             a.) Area change - Allows the caller to choose which type of
  164.                 files he/she wants (i.e. games,utils,etc.)  This also
  165.                 allows the sysop to seperate the files into such groups
  166.                 as suggested above.
  167.       
  168.             b.) File Listing - Allows the caller to view the available 
  169.                 files in the area chosen by using the "area change" 
  170.                 command (see installation section on Pages 4-10)
  171.  
  172.             c.) Yell at sysop - allows the caller to page the sysop for
  173.                 help or just to chat, if needed.
  174.  
  175.             d.) Create a restore list - Allows the caller to list up to
  176.                 eight files to be restored in one session
  177.  
  178.                 NOTE: it is my opinion that the available software of this
  179.                 type only permitts the restoration of one file at a time.
  180.  
  181.             e.) Download file(s) - Allows the caller to (after restore)  
  182.                 download the file(s) right from within the live door  
  183.                 instead of going back to the bulletin board software.
  184.                 At present, Z-modem is the expected protocol and this cannot
  185.                 be changed.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  ───────────────────────────────────────────────────────────────────────────
  200.   KITYTRAX Version 0.01b                                             Page 3
  201.  ───────────────────────────────────────────────────────────────────────────
  202.  
  203.   Limited Warranty - (Not much really)
  204.  
  205.  
  206.      KityTrax version 0.01b, Copyright 1992 (CyberDyne) comes `as is' with no
  207.    warranty, implied or otherwise.  KityTrax version 0.01b is distributed with
  208.    all necessary files contained within one archived file.  Distribution of
  209.    modified executable or document files is NOT permitted.  Reselling, leasing
  210.    or hiring of KityTrax is not permitted without first obtaining the prior
  211.    approval of the author.  KityTrax Version 0.01b remains the property of
  212.    the author at all times.
  213.  
  214.      Any archive method may be used to distribute KityTrax version 0.01b,
  215.    but I ask that you retain the same archive name.  ie.  The extension may
  216.    be altered to reflect the archiving method used, but the filename should
  217.    remain constant.
  218.  
  219.      KityTrax has been thoroughly tested by the author and a number of beta
  220.    testers.  This does not mean that KityTrax version 0.01b will work on
  221.    your system. The author makes no guarantee that it will work on any system
  222.    except his own.  Given the infinite number of possible "PC" configurations,
  223.    it is beyond the scope of this program to be compatible with them all.
  224.  
  225.      The "ONLY" warranty (if you can call it that), is that if you have a
  226.    problem with this program, (i.e. Bug,setup concerns/problems,etc)...
  227.    generally stuff that I can control....I give you my word as a professional
  228.    and a gentleman that I would do my best to correct the situation!  The only
  229.    cost to you is the $$ for the phone call or the stamp on an envelope.  Voice
  230.    support is FREE, I DO NOT charge for help, but it's got to be on YOUR dime.
  231.    I sincerely believe in supporting (at no additional charge to my customers)
  232.    the programs/products that I write/create.  I will try to remain as 
  233.    flexable and as tollerant as possible, but it only takes one person with
  234.    too much of a hassel, and it will come to a screeching halt!
  235.  
  236.      For  further information on KityTrax; reporting of bugs and suggestions
  237.    for improvements, I can be reached by one of the following methods:
  238.  
  239.     a.) Support bbs (414)426-2947
  240.         The Cloak Of Illusion II
  241.         24hrs a day ->chat mode 10am-2pm
  242.                     ->comment to sysop 24hrs
  243.                     ->Electronic Mail 24hrs [1:139/720] FidoNet
  244.     b.) U.S mail
  245.          Send all correspondence to:
  246.  
  247.          CyberDyne Systems
  248.          815 Jackson Street
  249.          Oshkosh,WI 54901
  250.  
  251.     c.) Voice Support
  252.          
  253.         Business phone # (414)426-2941
  254.         Business hours are: 10am - 2pm (M-Fr) central time zone
  255.         Note:
  256.             Answering machine is online for when I cannot personally take
  257.             your call.  I'm sorry but long distance calls will NOT be returned
  258.             by voice call, but will be responded to thru the U.S Mail
  259.  
  260.      d.) FidoNet Electronic Mail
  261.          
  262.          [1:139/720] running 24hr crash net/echomail
  263.  
  264.  
  265.  ───────────────────────────────────────────────────────────────────────────
  266.   KITYTRAX Version 0.01b                                             Page 4
  267.  ───────────────────────────────────────────────────────────────────────────
  268.  
  269. BUG REPORTING
  270.  
  271.   For the most part, if you come accross a error, you and/or the caller
  272. should see an error message displayed at the time.  Excecution of the
  273. program will suspend giving the person or persons time to write down the
  274. error code that's generated at the time of the problem.  When making Bug
  275. reports, please make sure that you give as full a description as possible of
  276. the problem, at what point was the program (i.e. main menu or area change
  277. menu, and what menu choice was selected (if any) )when the problem occurred.
  278. In other words, be as accurate and complete in description as possible.
  279. This will enable me to isolate the problem and correct it or work around it
  280. as best and as quickly as possible.
  281.  
  282.  
  283.  
  284.  
  285. ROOKIES' INSTALLATION GUIDE
  286.  
  287. NOTE: This section is for those who "MAY" be considered rookies at sysop'n...
  288.       it is NOT intended as an insult of any kind, but rather, is aimed at
  289.       providing more extensive help in the installation process!  If you are
  290.       more of a seasoned individual in the way of sysop'n, then skip this
  291.       stuff and proceed to the "quick installation guide" in the following
  292.       section.
  293.  
  294.   Installation of this program is really quite simplistic if you just take
  295. the time to think it out.  I am a firm believer of the "KISS" method....
  296. that stands for (K)eep (I)t (S)imple (S)tupid.  The first thing you want to
  297. do depends on whether you are setting up file areas for the first time or
  298. maybe you've decided to take some of the (for example) smaller or less
  299. popular files off the HD and put them into the tape system.  I'll attempt to
  300. give you both cenario's.
  301.  
  302. CENARIO #1 - "NEW file areas NOT already online"
  303.  
  304. I.)   Let's assume that you are setting up some "NEW" file areas and you have
  305. not defined them in your bbs software yet.  The first step would be to create
  306. the sub-directories on your hard drive that you will be backing up onto tape.
  307. In order to better illustrate, let's get an example going here.  In our
  308. example, let's assume that you've got all your "other" file directories off
  309. the root directory (i.e. c:\)and under a sub-directory called files:
  310.  
  311.   example: c:\files\games  <---previously existing file areas defined to bbs
  312.                |____\utils <---previously existing file areas defined to bbs 
  313.                |_____\bbs_utils <---previously existing file areas defined to
  314.                                     bbs
  315.  
  316. Let's also assume that the first file area that we want to add (for use with
  317. our tape backup system, will be called TPprog(Turbo Pascal programming
  318. files)....So we need to make another sub-directory under the "FILES"
  319. sub-directory and our example now looks like this:
  320.  
  321.  
  322.   example: c:\files\games
  323.                |____\utils
  324.                |_____\bbs_utils
  325.                |_____\TPprog
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  ───────────────────────────────────────────────────────────────────────────
  332.   KITYTRAX Version 0.01b                                             Page 5
  333.  ───────────────────────────────────────────────────────────────────────────
  334.  
  335.  
  336. II.)   OK, now that we have the needed sub-directory created, there's only one
  337. file that needs to be in this new sub-dir....and that's a "FILES.BBS".  A
  338. "FILES.BBS" is a plain ASCII text file that will contain the filenames &
  339. extensions as well as there respective size, and descriptions. The following
  340. is an example of what that should look like:
  341.  
  342.                   [Brief file area description could go here]
  343. ===============================================================================
  344.  
  345. KITYTRAX.BAS     27100 10-11-92  Qbasic source code for Kitytrax Tapedrive
  346.                                  software
  347. AREAMEN           1308 10-02-92  NON-color area change menu for KityTrax
  348. ACTIVITY LOG      3847 10-11-92  Activity log created by KityTrax
  349. KITYTRAX EXE     68114 10-11-92  Main Executible for KityTrax
  350. INSTALL  BAS      2220 10-09-92  Qbasic source code for KityTrax install prog.
  351.  
  352. -EOF-
  353.  
  354. For those who don't have the slightest idea as to how to get this the "EASY"
  355. way, just put all your files into the respective sub-dir (c:\files\TPprog).
  356. Then, type the following at your DOS prompt: 
  357.  
  358. "dir > files.bbs" (minus the quote marks of course). 
  359.  
  360. At this point, leave all the files that you intend to backup onto tape in
  361. each sub-directory for now, as they will be deleted later once you have made
  362. a backup of them.  
  363.  
  364. Then you will need to do some editing on the files.bbs, and you'll see what I 
  365. mean when you take a look at it. Strip out everything EXCEPT for the filenames,
  366. extensions, file sizes and date stamps.  Then while your in editing mode, (and 
  367. if you already know the descriptions) take the time to key in the file 
  368. descriptions for each of the filenames, if you don't have file descriptions
  369. yet, you can always come back to it and edit the file again.  Although you 
  370. don't have to, it is suggested that you put in a brief file area description 
  371. at the top of "FILES.BBS" text file as suggested in our above example.  
  372.  
  373. Now, your directory structure (according to our example) should look like this:
  374.  
  375.   example: 
  376.      
  377.     c:\files\games          <---previously existing file areas defined to bbs
  378.          |__\utils          <---previously existing file areas defined to bbs 
  379.          |__\bbs_utils      <---previously existing file areas defined to bbs
  380.          |__\TPprog         <---sub-dir created for use with KityTrax
  381.                  |____FILES.BBS   <---ASCII text file 
  382.                  |____BBS.ZIP
  383.                  |____CLOCK.ZIP
  384.                  |____etc.
  385.  
  386.   You would do the above two step (creation of sub-directory & files.bbs) for
  387. each of the file areas that you want available on tape.
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  ───────────────────────────────────────────────────────────────────────────
  398.   KITYTRAX Version 0.01b                                             Page 6
  399.  ───────────────────────────────────────────────────────────────────────────
  400.  
  401. Although, this documentation may tend to catre' to the "ROOKIE" sysop, it is
  402. beyond the scope of this manual to teach you how to use your IRWIN tape
  403. backup drive at this time.  Let's face it, certain assumptions must be made
  404. when writing a utility program such as this and knowing how to use ones tape
  405. backup drive is (unfortunately) one of those assumptions.  I will however be
  406. willing to act as an "UNOFFICIAL" tech support person, as long as it pertains
  407. to the use of "MY" program.  With this in mind......let's continue!
  408.  
  409. III.)   Step three will consist of doing a backup of those file areas & files
  410. that you want to be used in conjunction with the KityTrax tape drive file
  411. retrieval system.  One note worth mentioning at this point would be to write
  412. down somewhere the name of the backup set that you use when actually doing
  413. the backup, as you will need this information later when running the install
  414. program. 
  415.  
  416. IV.)    Once the backup process is complete and you have made a note as to
  417. what the backup set is called, then quit EZtape, and delete (in each sub-dir
  418. to be used with KityTrax) all the files with the exception of the FILES.BBS
  419. With our ongoing example in mind, your directory structure should now look like
  420. this :
  421.  
  422. c:\
  423.  |_ files\games               <---previously existing file areas defined to bbs
  424.            |____\utils        <---previously existing file areas defined to bbs
  425.            |_____\bbs_utils   <---previously existing file areas defined to bbs
  426.            |______\TPprog     <---sub-dir created for use with KityTrax
  427.                       |____FILES.BBS   <---ASCII text file 
  428.  
  429. V.)     Now that we have the files and sub-directories set up for use by
  430. KityTrax, it's time to actually install the live door!  To do this we need to
  431. create two sub-directories for KityTrax.  Keeping with our ongoing example,
  432. let's (again) assume that you keep all(if any) of your live doors in a
  433. sub-dircetory off the root directory called "DOORS" so the structure will now
  434. look like this:
  435.  
  436. c:\
  437.  |_ files\games               <---previously existing file areas defined to bbs
  438.  |         |____\utils        <---previously existing file areas defined to bbs
  439.  |         |_____\bbs_utils   <---previously existing file areas defined to bbs
  440.  |         |______\TPprog     <---sub-dir created for use with KityTrax
  441.  |                    |____FILES.BBS   <---ASCII text file 
  442.  |__doors
  443.      |____startrek            <----A star Trek trivia game
  444.      |____Ook                 <----Operation OverKill
  445.      |____KityTrax            <----This door that we're setting up now
  446.  
  447. In our DOORS sub-directory make another sub-directory and call it
  448. "KITYTRAX"....now, it doesn't have to be called this but what kind of author
  449. would I be if I didn't keep pushing the name of the program????
  450. right????........ NOT!!!!!!!!!!! sorry, had to lighten things up just a bit!
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  ───────────────────────────────────────────────────────────────────────────
  464.   KITYTRAX Version 0.01b                                             Page 7
  465.  ───────────────────────────────────────────────────────────────────────────
  466. ok, back to business....I mentioned that we needed to create TWO subs....the
  467. second sub-directory will be called RESTORE and in order to keep things in
  468. the tree as neat as possible, let's put the new "RESTORE" sub under the FILES
  469. sub-dir, so that your structure now looks like this:
  470.  
  471. c:\
  472.  |_ files\games               <---previously existing file areas defined to bbs
  473.  |         |____\utils        <---previously existing file areas defined to bbs
  474.  |         |_____\bbs_utils   <---previously existing file areas defined to bbs
  475.  |         |______\TPprog     <---sub-dir created for use with KityTrax
  476.  |         |          |____FILES.BBS   <---ASCII text file 
  477.  |         |_______\restore   <---sub-dir create for restoration of tape files
  478.  |__doors
  479.      |____startrek
  480.      |____Ook     <----Operation OverKill
  481.      |____KityTrax
  482.  
  483. Now that we have all the sub-directories made, it's time to unpack the
  484. KityTrax ZIP archive into the sub called "KITYTRAX".  With the archive now
  485. unpacked, we need to load and run the install program provided, in order to
  486. create a configuration file that will be required to run KityTrax.  So type the
  487. word "install" at your DOS prompt at this time and follow the
  488. prompts....remember I told you to use the KISS method and think things
  489. out????..... I hope you listened!
  490.  
  491. Here are the prompts that you MUST answer in order to configure KityTrax
  492. properly:
  493.  
  494. QUESTION      #1.) What is the default drive? (i.e. c:\)
  495. EXAMPLE       #1.) Most of the time it will be "C:\"
  496. EXPLAINATION  #1.) simply tell me on what drive are you working?
  497.  
  498.  
  499. QUESTION      #2.) What is the FULL path to where your DOOR.SYS file will 
  500.                    be located?
  501. EXAMPLE       #2.) With Wildcat v3.+ systems it's most likely going to be:
  502.                    c:\wc30\wcwork\node1
  503. EXPLAINATION  #2.) Two files called DOOR.SYS and USERINFO.DAT are created by
  504.                    wildcat when a caller enters a live door.  I need to know
  505.                    where this file is located.
  506.  
  507. QUESTION      #3.) What is the name of your BBS system?
  508. EXAMPLE       #3.) The Cloak Of Illusion II
  509. EXPLAINATION  #3.) The question should be self-explanitory
  510.  
  511.  
  512. QUESTION      #4.) Are you using GAP or PCboard BBS software? 
  513.                    (enter 0=GAP, 1=PCboard)
  514. EXAMPLE       #4.) 0
  515. EXPLAINATION  #4.) This information is not used at this time, however you
  516.                    should enter the number zero since GAP bbs software is 
  517.                    about the closest to wildcat that you can get.
  518.  
  519.  
  520. QUESTION      #5.) What is the FULL path to your Ez-Tape software?
  521.                    (i.e. c:\eztape)
  522. EXAMPLE       #5.) C:\eztape
  523. EXPLAINATION  #5.) Unless you want to be different for some reason, they
  524.                    suggest that their software be installed off the root
  525.                    directory so let's assume that it would be.
  526.  
  527.  
  528.  
  529.  ───────────────────────────────────────────────────────────────────────────
  530.   KITYTRAX Version 0.01b                                             Page 8
  531.  ───────────────────────────────────────────────────────────────────────────
  532.  
  533.  
  534. QUESTION      #6.) What is the FULL path for restoring files to?
  535. EXAMPLE       #6.) C:\FILES\RESTORE
  536. EXPLAINATION  #6.) Remember I suggested putting the restore sub-directory
  537.                    under the same sub as all your other file areas in order
  538.                    to keep the tree looking as neat as possible?
  539.  
  540. QUESTION      #7.) What is the name of the backup-set for which the files are
  541.                    located in?
  542. EXAMPLE       #8.) BBS
  543. EXPLAINATION  #8.) This can be any name that follows DOS rules.  In the
  544.                    example for this question I just called it BBS, which
  545.                    DOES correspond with my backup set.  Remember I told
  546.                    you to write it down when you were doing your backup?
  547.  
  548. QUESTION      #9.) Enter the FULL path for where you're installing this
  549.                    software?
  550. EXAMPLE       #9.) C:\DOORS\KITYTRAX
  551. EXPLAINATION  #9.) Here, you're telling me where the KityTrax program is
  552.                    being installed.
  553.  
  554. QUESTION     #10.) Enter the FULL path where the USERINFO.DAT file is locate?
  555. EXAMPLE      #10.) C:\WC30\WCWORK\NODE1
  556. EXPLAINATION #10.) I believe for wildcat v3.+ systems this file is also located
  557.                    in the node1 sub-directory.
  558.  
  559. QUESTION     #11.) Enter FULL path to file areas (i.e. files\games)
  560.                    DO NOT use a drive designator!
  561. EXAMPLE      #11.) FILES\GAMES
  562. EXPLAINATION #11.) The rest of the questions ask for file areas.  This is
  563.                    where you tell KityTrax what sub-dir's you created for
  564.                    file areas that are to be used with KityTrax.  As prompted
  565.                    DO NOT use a drive designator (i.e. C:\). Take a close
  566.                    look at the example for this question and the one given
  567.                    with the question.  In between entering each file area,
  568.                    you will be prompted as to whether you wish to add any more
  569.                    file areas.  If yes, the press "y" and you will be
  570.                    prompted for another file area. If NO, press "n" and you
  571.                    will end the installation process and the info will be saved
  572.                    to a file called KITYTRAX.CNF
  573.  
  574. What follows is an example of the KITYTRAX.CNF file that is created by
  575. running the install program.  I've also include with the ZIP archive, a
  576. sample KITYTRAX.CNF file as a text file.  The format of the *.CNF file comes
  577. out different, compared to the order of the questions when running the
  578. install program as you may notice in the following example.
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  ───────────────────────────────────────────────────────────────────────────
  596.   KITYTRAX Version 0.01b                                             Page 9
  597.  ───────────────────────────────────────────────────────────────────────────
  598.  
  599.  
  600. c:\wc30\wcwork\node1                     <--Path to DOOR.SYS
  601. The Cloak Of Illusion II                 <--Name of your BBS
  602. 0                                        <--Not used at this time
  603. c:\                                      <--Default drive
  604. c:\eztape                                <--Path to Eztape software
  605. c:\files\restore                         <--Path the file restore sub-dir
  606. bbs                                      <--Name of backup set
  607. c:\qb45\unpack2                          <--Path to where KityTrax is installed
  608. c:\wc30\wcwork\node1                     <--Path to USERINFO.DAT
  609. files\games                              <--Path to file areas
  610. DO NOT REMOVE THIS LINE              'From this point, if you do not define
  611. DO NOT REMOVE THIS LINE              'any sub-dir as file areas, the line 
  612. DO NOT REMOVE THIS LINE              'you see to the left will be automatically
  613. DO NOT REMOVE THIS LINE              'be appended to the end of the file.
  614. DO NOT REMOVE THIS LINE
  615. DO NOT REMOVE THIS LINE
  616. DO NOT REMOVE THIS LINE
  617. DO NOT REMOVE THIS LINE
  618. DO NOT REMOVE THIS LINE
  619. DO NOT REMOVE THIS LINE
  620. DO NOT REMOVE THIS LINE
  621. DO NOT REMOVE THIS LINE
  622. DO NOT REMOVE THIS LINE
  623. DO NOT REMOVE THIS LINE
  624. DO NOT REMOVE THIS LINE
  625. DO NOT REMOVE THIS LINE
  626. DO NOT REMOVE THIS LINE
  627. DO NOT REMOVE THIS LINE
  628. DO NOT REMOVE THIS LINE
  629. DO NOT REMOVE THIS LINE
  630. DO NOT REMOVE THIS LINE
  631. DO NOT REMOVE THIS LINE
  632. DO NOT REMOVE THIS LINE
  633. DO NOT REMOVE THIS LINE
  634. DO NOT REMOVE THIS LINE
  635.  
  636. OK?...........let's take a few minutes to recapp what we've done so far.
  637.  
  638.  
  639. Step 1....We created the necessary sub-directories as file areas to be used
  640.           by KityTrax.
  641.  
  642. Step 2....We copied the files/archives that we wanted to have into those
  643.           sub-directories
  644.  
  645. Step 3....Using the "type" command provided by DOS, we then created a
  646.           FILES.BBS and edited it so that it looked something like the
  647.           following:
  648.  
  649.                   [Brief file area description could go here]
  650. ===============================================================================
  651.  
  652. KITYTRAX.BAS     27100 10-11-92  Qbasic source code for Kitytrax Tapedrive
  653.                                  software
  654. AREAMEN           1308 10-02-92  NON-color area change menu for KityTrax
  655. ACTIVITY LOG      3847 10-11-92  Activity log created by KityTrax
  656. KITYTRAX EXE     68114 10-11-92  Main Executible for KityTrax
  657. INSTALL  BAS      2220 10-09-92  Qbasic source code for KityTrax install prog.
  658.  
  659. -EOF-
  660.  
  661.  ───────────────────────────────────────────────────────────────────────────
  662.   KITYTRAX Version 0.01b                                             Page 10
  663.  ───────────────────────────────────────────────────────────────────────────
  664.  
  665. Step 4....Using the EzTape software provided by Irwin Magnetics, we then did
  666.           a backup of those newly created sub-dir's with all the files still
  667.           in place, making note of what we called the backup set.
  668.  
  669. Step 5....Once done with doing the backup and we made a note of the backup
  670.           set name, we then deleted all the file/archives EXCEPT for the 
  671.           FILES.BBS text file.
  672.  
  673. Step 6....While still in the C:\FILES sub-directory, we also created a 
  674.           sub-dir and called it RESTORE (c:\files\restore)
  675.  
  676. Step 7....We changed to the DOORS sub-directory and created a place for
  677.           installation of the live door, and called it KITYTRAX.
  678.  
  679. Step 8....We UNzipped the archive in the KityTrax sub-dir
  680.  
  681. Step 9....We ran the installation program in order to create the CNF file
  682.           needed for KityTrax to operate.
  683.  
  684. And that brings us up to where we are now.  The ONLY step for completing
  685. installation that we haven't done yet, is making the appropriate batch file
  686. for wildcat in order to run the program.  Sample Batch files will be included
  687. with the distribution archive, but the name of the batch file depends as to
  688. whether you are going to run the door off one of the menus as a DOS hook or
  689. as a normal live door from the doors menu, so be sure to consult your wildcat
  690. manual for information on those items.  That pretty much takes care of the
  691. preparation and installation of KityTrax from start to finish.  I hope that
  692. (for the novice sysop anyway.....) it was of some help, rather the a
  693. hinderance, by going into a longer and more detailed explaination of the
  694. install process.  Feedback is the best tool to a programmer, so if you have
  695. any comments about the program, manual, or the installation
  696. explaination....feel free to drop me a line or give me a call during business
  697. hours.
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  ───────────────────────────────────────────────────────────────────────────
  728.   KITYTRAX Version 0.01b                                             Page 11
  729.  ───────────────────────────────────────────────────────────────────────────
  730. GRIZZLED SYSOP'S INSTALLATION GUIDE
  731.  
  732. Step 1.... Create the necessary sub-directories for file areas to be used
  733.           by KityTrax.
  734.  
  735. Step 2....Copie the files/archives that you want to have, into those
  736.           sub-directories
  737.  
  738. Step 3....Using the "type" command provided by DOS, create a
  739.           FILES.BBS and edit it so that it looks something like the
  740.           following:
  741.  
  742.                   [Brief file area description could go here]
  743. ===============================================================================
  744.  
  745. KITYTRAX.BAS     27100 10-11-92  Qbasic source code for Kitytrax Tapedrive
  746.                                  software
  747. AREAMEN           1308 10-02-92  NON-color area change menu for KityTrax
  748. ACTIVITY LOG      3847 10-11-92  Activity log created by KityTrax
  749. KITYTRAX EXE     68114 10-11-92  Main Executible for KityTrax
  750. INSTALL  BAS      2220 10-09-92  Qbasic source code for KityTrax install prog.
  751.  
  752. -EOF-
  753.  
  754. Step 4....Using the EzTape software provided by Irwin Magnetics, do a backup
  755.           of those newly created sub-dir's with all the files still in place,
  756.           making note of what you call the backup set.
  757.  
  758. Step 5....Once done with doing the backup and make a note of the backup
  759.           set name, then delete all the file/archives EXCEPT for the 
  760.           FILES.BBS text file.
  761.  
  762. Step 6....While still in the C:\FILES sub-directory, create a 
  763.           sub-dir and call it RESTORE (c:\files\restore)
  764.  
  765. Step 7....Change to the DOORS sub-directory and create a place for
  766.           installation of the live door, and call it KITYTRAX.
  767.  
  768. Step 8....UNzip the archive in the KityTrax sub-dir
  769.  
  770. Step 9....Run the installation program in order to create the CNF file
  771.           needed for KityTrax to operate.
  772.  
  773.   The ONLY step for completing installation that we haven't done yet, is 
  774. making the appropriate batch file for wildcat in order to run the program.  
  775. Sample Batch files will be included with the distribution archive, but the 
  776. name of the batch file depends on whether you are going to run the door off
  777. one of the menus as a DOS hook or as a normal live door from the doors menu, 
  778. so be sure to consult your wildcat manual for information on those items.  
  779. That pretty much takes care of the preparation and installation of KityTrax 
  780. from start to finish.  I hope that (for the novice sysop anyway.....) it was 
  781. of some help, rather the a hinderance, by going into a longer and more detailed
  782. explaination of the install process.  Feedback is the best tool to a 
  783. programmer, so if you have any comments about the program, manual, or the 
  784. instal explaination....feel free to drop me a line or give me a call during 
  785. business hours.
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  ───────────────────────────────────────────────────────────────────────────
  794.   KITYTRAX Version 0.01b                                             Page 12
  795.  ───────────────────────────────────────────────────────────────────────────
  796.  
  797. MENU CREATION
  798.  
  799.   Although KityTrax comes with sample menus (main menu and area change menu),
  800. you still may want to customize these menus so as to blend into your bbs system
  801. better.  The sample menus were created using an ANSI drawing program called 
  802. THE DRAW.  This makes it simple for the sysop to either create new
  803. menus of their own or to alter the sample ones.  It is not my intention to
  804. indorse any program other than my own, but rather should be seen as a
  805. professional courtesy.  These menus can look like anything the sysop wants
  806. them to look like, however the main menu commands MUST start with the KEY
  807. LETTERS/SYMBOLS that are used in the samples, and the KEY LETTERS for the
  808. area change menu MUST use the alphabetical letters of [A thru J]....otherwise
  809. the graphics can be as simple or as complex as the sysop wants.
  810.  
  811.  
  812. USING FILE AREAS ALREADY ESTABLISHED
  813.  
  814.   Remember when I said that I was going to give you two possible cenario's?
  815. well, I intend to keep my promise.....geeze sorta sounds like something Ross
  816. Perot might say huh?  <ARRRRRGH>
  817.  
  818. Seriously....here it is:
  819.  
  820. CENARIO #2 - "Using already existing file areas"
  821.  
  822.   Let's NOW assume that you are a grizzled vet of sysop'n (or at least you've
  823. dried the wetness out from behind the ears by now).  By taking on that
  824. thought we can acknowlege that someone may already be running a bulletin
  825. board system and just want to add some more space without going out and
  826. buying another or bigger hard drive.  Enter ME! and KityTrax of
  827. course.....and let's say that you've noticed a drop in traffic in one or more
  828. of your file areas.  You don't want to take them offline completely????? but
  829. yet you'd like to open up the space on your HD for other things or maybe your
  830. thinking of adding a NEW file area....(sound familiar?).  Well, why not MOVE
  831. those seldom used files & file areas to a online tape backup?  they can still
  832. be accessed by callers and it will open up space for that NEW file area.  I
  833. know, I know.....I am starting to sound like one of those dog-gone'd 30
  834. minute info-mercials!  ok! ok! let's get down to business, but consider that
  835. I am now up to line 836 of this manual and have been going at this for about
  836. 9 hours straight!...
  837.  
  838. ok....assumming your a wildcat sysop, here's what you do.
  839.  
  840. STEP 1.)    Do a backup of all the already existing file areas that you want to
  841. use with KityTrax.
  842.  
  843. STEP 2.)     Go into each sub-directory that you wish to put on the tape system
  844. and create a FILES.BBS by using the "DIR" command provided by DOS.
  845.          
  846.          DIR > FILES.BBS
  847.  
  848. This will pipe a directory listing of the files in the "current"
  849. sub-directory into a ASCII text file and call it FILES.BBS for you...all in
  850. one command!  Do this command in each of the already existing file areas and
  851. edit them as you create them so that they look like the example shown in
  852. previous pages.
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  ───────────────────────────────────────────────────────────────────────────
  860.   KITYTRAX Version 0.01b                                             Page 13
  861.  ───────────────────────────────────────────────────────────────────────────
  862.  
  863. CENARIO #2 - "Using already existing file areas" - cont'd
  864.  
  865. STEP 3.)      Providing that you've done step one and step two, you can now go
  866. ahead and delete all the archive/files that you might have in each of those
  867. sub-directories, but DON'T delete the FILES.BBS text file that you've created
  868. just recently!
  869.  
  870. STEP 4.)      Since you've already defined these files and file areas in your 
  871. BBS software prior to setting up "this" program, you'll need to go into 
  872. MAKEWILD (for wildcat systems anyway) and remove those file areas that "were" 
  873. defined.  If you plan on "keeping" the "file areas" but getting rid of the 
  874. files in those areas, then you'll have to either use WCpro! or get into the bbs
  875. locally and then the sysop menu/file section and manually delete those files.
  876.  
  877. STEP 5.)      You can now pick up with the normal installation of the program
  878. by running the install program for KityTrax and following the directions for
  879. the other cenario.
  880.  
  881.  
  882. KNOWN PROBLEMS WITH THIS PROGRAM
  883.  
  884. I wished I could say that this program will be bug free and be able to please
  885. all of the people all of the time, but in reality?????  NOT!!!!!!!!!!!!!!!
  886.  
  887. 1.)  If a caller is in Monochrome mode when entering this door?....for some 
  888. reason unknown at this time, it displays the welcome screen and then just 
  889. swaps back to loading wildcat.  I'm fairly sure that it's just some little 
  890. stupid thing that I've overlooked and should be corrected by the next Beta 
  891. release.
  892.  
  893. 2.)  Because of apparent memory management limitations of the language, I
  894. have not done anything in the way of governing time used in KityTrax.  In
  895. other words, I don't deduct time used in the door from total time allowed
  896. online while logged into wildcat.  There again, I hope to have this
  897. implemented by the next release.
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  ───────────────────────────────────────────────────────────────────────────
  926.   KITYTRAX Version 0.01b                                             Page 14
  927.  ───────────────────────────────────────────────────────────────────────────
  928.  
  929. SYSTEM REQUIREMENTS
  930.  
  931. NOTE:  This program was written with the intention of being run on an IBM PC 
  932. with a minimum of 640k memory.  It is NOT concievable that it would run on
  933. anything less because of large memory requirements by EZtape and also
  934. KityTrax.  
  935.  
  936. IBM PC or 100% clone
  937. Hard Drive (large enough to run a bulletin board)
  938. 640k RAM
  939. IRWIN(tm) Tape Backup Drive (internal or External)
  940. Eztape backup software 2.2 w/compression enhancement
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  ───────────────────────────────────────────────────────────────────────────
  992.   KITYTRAX Version 0.01b                                             Page 15
  993.  ───────────────────────────────────────────────────────────────────────────
  994.  
  995.  
  996. I realize that this program might seem a bit rushed, but I wanted to get the
  997. program out, so that other people with my delemma could benefit from it as
  998. well.....Plus I would like to make a buck or two from it as well <grin>
  999.  
  1000. I've been running a public bbs for over 5 years now, and I've "always" used
  1001. wildcat software.  I have nothing but sincere admiration for the folks at
  1002. Mustang Software for writing such an outstanding bbs package, and I hope that 
  1003. this utility/live door program will do a little bit of justice for wildcat.  
  1004. When you live in the north-central part of the United States, you don't really 
  1005. see much of the bbsing community, but I know there's got to be others out there
  1006. with the same type of problem that prompted me to develope this door program.
  1007.  
  1008. I hope to make many enhancements to this door program over time....and if
  1009. encouragement is steady enough, I will improve on it as quickly as possible.
  1010. Some of the possible enhancements could be as follows:
  1011.  
  1012. 1.) Full support for wildcat door information files, such as deducting the
  1013. time that a caller was in this door from the time the caller has online for
  1014. that call.  Deducting # of files and there Kbytes due to downloading is
  1015. another item that needs to be dealt with.
  1016.  
  1017. 2.) Support for checking security level, incase the sysop wants to keep
  1018. certain sec. levels out of this door for some reason.
  1019.  
  1020. 3.) Phrase searching was an option that I already have the source code
  1021. developed for, however it had to be taken out due to memory limitations.
  1022.  
  1023. 4.) Filename searching was also another option that was taken out due to
  1024. memory limitations.
  1025.  
  1026. 5.)  Additional download protocols will be added.
  1027.  
  1028. 6.)  Uploading may also be a possibility
  1029.  
  1030.  
  1031. 7.)  Making this program compatible with other bbs packages as well as with
  1032. older/newer versions of wildcat is going to be a HIGH priority with me over
  1033. the next few months.
  1034.  
  1035.  
  1036. PLEASE NOTE:  I am always open to suggestions for enhancements, so if you
  1037. have something in mind that you'd like to see added, by all means, drop me a
  1038. line somehow.
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  ───────────────────────────────────────────────────────────────────────────
  1058.   KITYTRAX Version 0.01b                                             Page 16
  1059.  ───────────────────────────────────────────────────────────────────────────
  1060.  
  1061. ACKNOWLEGEMENTS
  1062.  
  1063. The following companies and/or their products may be registered trademarks of
  1064. said companies and were ONLY mentioned in this manual for illustration
  1065. purposes. 
  1066.  
  1067.                      IBM  (International Business machines)
  1068.                      IRWIN (Irwin Magnetic Systems, Inc.)
  1069.                      EzTape (Irwin Magnetic Systems, Inc.)
  1070.                      Colorado Memory Systems
  1071.                      Wildcat (Mustang Software, Inc.)
  1072.                      Zmodem
  1073.                      GAP Bulletin board systems (GAP Development)
  1074.                      PCboard
  1075.                      Operation OverKill
  1076.                      Pkzip
  1077.                      TheDraw
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  ───────────────────────────────────────────────────────────────────────────
  1124.   KITYTRAX Version 0.01b                                             Page 17
  1125.  ───────────────────────────────────────────────────────────────────────────
  1126.  
  1127. COPYRIGHTS & REGISTRATION OF THIS PROGRAM
  1128.  
  1129. I.)    Copyrights -  This program and it's documentation is the copyrighted
  1130. work of Bryan E. Paulson & CyberDyne Systems, and may NOT be duplicated
  1131. without the express written consent of the author.  You are however, hereby
  1132. given permission to make a working copy of your KityTrax archive or disk (if
  1133. you recieved it directly from CyberDyne Systems) in order to protect your
  1134. investment.  If for some reason, your working copy becomes inoperative, you
  1135. may at that time make another copy of theis program.  You are also hereby
  1136. given permission to install KITYTRAX on a perminant storage device (a hard
  1137. disk drive) and if that installed copy becomes inoperative, you may at that
  1138. time, re-install KITYTRAX again on the perminant storage device.
  1139.  
  1140. II.)    If after a trial period of 21 days, you find KITYTRAX useful and
  1141. continue to use it, you are required to register the program.  If you choose
  1142. NOT to register, then you MUST cease to use this program and MUST remove it
  1143. from any perminant storage device (hard drive,floppy drive,tape drive,etc)
  1144. that it is installed on.  This does NOT include keeping the original archive,
  1145. however, since you may decide to register at another time.
  1146.  
  1147.     The registration price for single computer use and also registration
  1148. prices for site locations will be posted in the text file REGISTER.FRM that
  1149. is included in the distribution archive.